DATABASE ITEM VERSIONING 



FIELD OF THE INVENTION 

This invention relates generally to databases such as 
Structured Query Language (SQL) databases, and more particularly 
to the versioning of items such as text -stream stored procedures 
(SP's) of such databases. 

BACKGROUND OF THE INVENTION 

Databases have become increasingly popular and important in 
today's computerized world. While there are many different types 
of databases, one common database is the Structured Query 
Language (SQL) database. SQL is a language used to interrogate 
and process data in a relational database; SQL commands can be 
used to interactively work with a database or can be embedded 
within a programming language to interface to a database. 
Programming extensions to SQL have turned it into a full-blown 
database programming language. 

Within a database (DB) , a stored procedure (SP) is a SQL 
program that is stored in the database, and which is executed by 
calling it directly from a client or from a database trigger. 
When the SQL procedure is stored in the database, for example, it 
does not have to be replicated in each client. This saves 



programming effort, especially when different client user 
interfaces and development systems are used. A stored procedure 
can be viewed as a standard computer program in some respects, 
with one important difference: while standard computer programs 
are usually stored as one or more files on a storage such as a 
hard disk drive, a stored procedure is not stored as a separate 
file or files, but rather as text and binary streams within the 
database itself. 

Enterprise (viz., wide-scale) SQL database developers and 
administrators commonly build mission-critical systems, the 
failure of which can be catastrophic. Therefore, they are 
protective of the code, such as stored procedures, that exist on 
both production and development databases. To store their code 
in such a manner as to ensure protection, developers usually use 
basic files, and then utilize long compile scripts to execute 
them and create their databases. This is less than desirable, 
however, since ultimately the database itself stores the code as 
a binary stream, as has been described. 

Thus, once the databases are in production, anyone with 
system administrator permission can change code such as stored 
procedures, without any historical record as to what changes have 
been made. Bugs and errors introduced into the procedures, for 
example, may be difficult to trace. Furthermore, the database 



administrator is unable to examine how the code has changed over 
time. For these and other reasons, there is a need for the 
present invention . 

SUMMARY OF THE INVENTION 

The invention relates to the versioning of items such as 
stored procedures in databases. In one embodiment, a system 
includes a program such as an editor, a database, a source code 
control (SCO system, and a mechanism. An editor program 
provides for the editing of an item such as a stored procedure 
of a database such as a SQL database. The database includes the 
stored procedure (for example, a version of the stored 
procedure) , and the source code control system stores versions of 
the stored procedure. The mechanism provides for the checking in 
and checking out of the stored procedures. Besides stored 
procedures, the invention is applicable to any other item of 
databases, including but not limited to: views, triggers, 
constraints, persisted queries and scripts for creating any 
database object, such as tables, indexes, domains, etc., as those 
of ordinary skill within the art can appreciate. 

In this manner, at least/some embodiments of the invention 
provide for advantages not Sound in the prior art. For example, 
the mechanism that provider for checking in and checking out of 



the stored procedures of the database^ provides for effective 
versioning of the stored procedures'. The mechanism keeps track 
of users who wish to edit the stored procedures, and once they 
have been changed, the mechanises keeps track of the changes that 
have been made to the stored procedures. Thus, when a bug or 
error has been introduced iiyco a stored procedure can be 
determined, and the database administrator is able to determine 
the history of changes Mde to a particular stored procedure. 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 shows a computer in conjunction with which 
embodiments of the invention may be practiced; 

FIG. 2 shows a diagram of a computerized system in 
accordance with an embodiment of the invention; 

FIG. 3 shows a flowchart of a check-out method according to 
an embodiment of the invention; and, 

FIG. 4 shows a flowchart of a check- in method according to 
an embodiment of the invention. 

DETAILED DESCRIPTION OF THE INVENTION 

In the following detailed description of exemplary 
embodiments of the invention, reference is made to the 
accompanying drawings which form a part hereof, and in which is 
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shown by way of illustration specific exemplary embodiments in 
which the invention may be practiced. These embodiments are 
described in sufficient detail to enable those skilled in the art 
to practice the invention, and it is to be understood that other 
embodiments may be utilized and that logical, mechanical, 
electrical and other changes may be made without departing from 
the spirit or scope of the present invention. The following 
detailed description is, therefore, not to be taken in a limiting 
sense, and the scope of the present invention is defined only by 
the appended claims. 

For example, the following detailed description is provided 
in relation to database stored procedures. However, as those of 
ordinary skill within the art can appreciate, the invention is 
not limited to database items that are stored procedures, but 
can be applied to any other type of database items. Such items 
include, but are not limited to, views, triggers, constraints, 
persisted queries and scripts for creating any database object, 
such as tables, indexes, domains, etc. 

Some portions of the detailed descriptions which follow are 
presented in terms of algorithms and symbolic representations of 
operations on data bits within a computer memory. These 
algorithmic descriptions and representations are the means used 
by those skilled in the data processing arts to most effectively 



convey the substance of their work to others skilled in the art. 

An algorithm is here, and generally, conceived to be a self- 
consistent sequence of steps leading to a desired result. The 
steps are those requiring physical manipulations of physical 
quantities. Usually, though not necessarily, these quantities 
take the form of electrical or magnetic signals capable of being 
stored, transferred, combined, compared, and otherwise 
manipulated. It has proven convenient at times, principally for 
reasons of common usage, to refer to these signals as bits, 
values, elements, symbols, characters, terms, numbers, or the 
like. It should be borne in mind, however, that all of these and 
similar terms are to be associated with the appropriate physical 
quantities and are merely convenient labels applied to these 
quantities. Unless specifically stated otherwise as apparent 
from the following discussions, it is appreciated that throughout 
the present invention, discussions utilizing terms such as 
"processing" or "computing" or "calculating" or "determining" or 
"displaying" or the like, refer to the action and processes' of a 
computer system, or similar electronic computing device, that 
manipulates and transforms data represented as physical 
(electronic) quantities within the computer system's registers 
and memories into other data similarly represented as physical 
quantities within the computer system memories or registers or 



other such information storage, transmission or display devices. 



Computer 

Referring to FIG. 1, a diagram of the hardware and operating 
environment in conjunction with which embodiments of the 
invention may be practiced is shown. The description of FIG. 1 
is intended to provide a brief, general description of suitable 
computer hardware and a suitable computing environment in 
conjunction with which the invention may be implemented. 
Although not required, the invention is described in the general 
context of computer-executable instructions, such as program 
modules, being executed by a computer, such as a personal 
computer. Generally, program modules include routines, programs, 
objects, components, data structures, etc., that perform 
particular tasks or implement particular abstract data types. 

Moreover, those skilled in the art will appreciate that the 
invention may be practiced with other computer system 
configurations, including hand-held devices, multiprocessor 
systems, microprocessor-based or programmable consumer 
electronics, network PC's, minicomputers, mainframe computers, 
and the like. The invention may also be practiced in distributed 
computing environments where tasks are performed by remote 
processing devices that are linked through a communications 



network. In a distributed computing environment, program modules 
may be located in both local and remote memory storage devices. 

The exemplary hardware and operating environment of FIG. 1 
for implementing the invention includes a general purpose 
computing device in the form of a computer 20, including a 
processing unit 21, a system memory 22, and a system bus 23 that 
operatively couples various system components include the system 
memory to the processing unit 21. There may be only one or there 
may be more than one processing unit 21, such that the processor 
of computer 20 comprises a single central -processing unit (CPU) , 
or a plurality of processing units, commonly referred to as a 
parallel processing environment. The computer 20 may be a 
conventional computer, a distributed computer, or any other type 
of computer; the invention is not so limited. 

The system bus 2 3 may be any of several types of bus 
structures including a memory bus or memory controller, a 
peripheral bus, and a local bus using any of a variety of bus 
architectures. The system memory may also be referred to as 
simply the memory, and includes read only memory (ROM) 24 and 
random access memory (RAM) 25. A basic input/output system (BIOS) 
26, containing the basic routines that help to transfer 
information between elements within the computer 20, such as 
during start-up, is stored in ROM 24. The computer 20 further 
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includes a hard disk drive 27 for reading from and writing to a 
hard disk, not shown, a magnetic disk drive 28 for reading from 
or writing to a removable magnetic disk 29, and an optical disk 
drive 3 0 for reading from or writing to a removable optical disk 
31 such as a CD ROM or other optical media. 

The hard disk drive 27, magnetic disk drive 28, and optical 
disk drive 30 are connected to the system bus 23 by a hard disk 
drive interface 32, a magnetic disk drive interface 33, and an 
optical disk drive interface 34, respectively. The drives and 
their associated computer- readable media provide nonvolatile 
storage of computer- readable instructions, data structures, 
program modules and other data for the computer 20. It should be 
appreciated by those skilled in the art that any type of 
computer-readable media which can store data that is accessible 
by a computer, such as magnetic cassettes, flash memory cards, 
digital video disks, Bernoulli cartridges, random access memories 
(RAMs) , read only memories (ROMs), and the like, may be used in 
the exemplary operating environment. 

' A number of program modules may be stored on the hard disk, 
magnetic disk 29, optical disk 31, ROM 24, or RAM 25, including 
an operating system 35, one or more application programs 36, 
other program modules 37, and program data 38. A user may enter 
commands and information into the personal computer 2 0 through 



input devices such as a keyboard 40 and pointing device 42. 
Other input devices (not shown) may include a microphone, 
joystick, game pad, satellite dish, scanner, or the like. These 
and other input devices are often connected to the processing 
unit 21 through a serial port interface 46 that is coupled to the 
system bus, but may be connected by other interfaces, such as a 
parallel port, game port, or a universal serial bus (USB) . A 
monitor 47 or other type of display device is also connected to 
the system bus 2 3 via an interface, such as a video adapter 48. 
In addition to the monitor, computers typically include other 
peripheral output devices (not shown) , such as speakers and 
printers . 

The computer 2 0 may operate in a networked environment using 
logical connections to one or more remote computers, such as 
remote computer 49. These logical connections are achieved by a 
communication device coupled to or a part of the computer 20; the 
invention is not limited to a particular type of communications 
device. The remote computer 49' may be another computer, a 
server, a router, a network PC, a client, a peer device or other 
common network node, and typically includes many or all of the 
elements described above relative to the computer 20, although 
only a memory storage device 50 has been illustrated in FIG. 1. 
The logical connections depicted in FIG. 1 include a local -area 
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network (LAN) 51 and a wide-area network (WAN) 52. Such 
networking environments are commonplace in office networks, 
enterprise-wide computer networks, intranets and the Internal, 
which are all types of networks. 
5 When used in a LAN- networking environment, the computer 2 0 

is connected to the local network 51 through a network interface 
or adapter 53, which is one type of communications device. When 
used in a WAN-networking environment, the computer 2 0 typically 
includes a modem 54, a type of communications device, or any 
piO other type of communications device for establishing 

*Js3 

m communications over the wide area network 52, such as the 

IH Internal. The modem 54, which may be internal or external, is 

connected to the system bus 23 via the serial port interface 46. 
JL^ In a networked environment, program modules depicted relative to 

Iris the personal computer 20, or portions thereof, may be stored in 
!-pi the remote memory storage device. It is appreciated that the 
network connections shown are exemplary and other means of and 
communications devices for establishing a communications link 
between the computers may be used. 
20 The hardware and operating environment in conjunction with 

which embodiments of the invention may be practiced has been 
described. The computer in conjunction with which embodiments of 
the invention may be practiced may be a conventional computer, a 
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distributed computer, or any other type of computer; the 
invention is not so limited. Such a computer typically includes 
one or more processing units as its processor, and a computer- 
readable medium such as a memory. The computer may also include 
a communications device such as a network adapter or a modem, so 
that it is able to communicatively couple other computers. 

System 

Referring next to FIG. 2, a diagram of a system in 
accordance with an embodiment of the invention is shown. The 
system includes a database 200, a SCC system 202, a mechanism 
2 04, and an editor 2 06. The system may be implemented over one 
or more computers, such as that described in the preceding 
section of the detailed description. In the case where the 
system is implemented over more than one computer, it may be 
implemented in what is known as a client-server architecture, or 
in what is known as a distributed system. The invention is not 
limited to a particular architecture, however, for the 
implementation of the system of FIG. 2. 

The database 2 00 may be any type of database, such as a SQL 
database known in the art. The database 200 stores records, or 
data, and also code, such as stored procedures as have been 
described in the background section. One such stored procedure 



is shown as stored procedure 2 08, which is a binary stream 
including a compiled part 210 and a text part 212 (those of 
ordinary skill within the art can appreciate that the part 210 
and the part 212 can in another embodiment be stored as separated 
streams) . The text part 212 acts as the source code of the 
compiled part 210. Those of ordinary skill within the art can 
appreciate, however, that the text part 212 may not be present, 
such that only the compiled part 210 is present. 

The SCC system 202 stores versions of stored procedures, 
such as the stored procedure 208 stored in the database 200, and 
the stored procedure 214. The stored procedure 214 also has a 
compiled part 216 and a text part 218. Like the stored procedure 
208, the text part 218 of the stored procedure 214 acts as the 
source code of the compiled part 216. Those of ordinary skill 
within the art can appreciate that the text part 218 may not be 
present, such that only the compiled part 216 is present. 

In one embodiment of the invention, the SCC system 202 is 
Visual Source Safe, from Microsoft Corp., which is a stand-alone 
product shipped as part of Visual Studio, a development 
environment for developing code such as stored procedures 
available from Microsoft Corp. The Visual Source Safe has OLE 
automation interfaces, as known in the art, for checking in and 
checking out different versions of code, such as stored 



procedures. The invention is not limited, however, to the 
embodiment utilizes Visual Source Safe and/or Visual Studio. 

The SCC system 202, as those of ordinary skill within the 
art can appreciate, is not limited to only handling database 
(e.g., SQL database) streams, but in other embodiments of the 
invention, can store other types of streams, such as including 
but not limited to: C code, Microsoft Word or other word 
processor documents, etc. 

Furthermore, "checking out" as referred to herein refers to 
the concept of tagging a given item such as a stored procedure 
such that the item is "in use" by a given user and otherwise 
cannot be edited or modified by another user (although this 
second user may be able to use a read-only version of the stored 
procedure) , until the item has been checked back in. Thus, 
"checking in" as referred to herein refers to the concept of 
tagging a given item that has been previously checked out by a 
given user such that this user is finished modifying or editing 
the item -- such that other users are now able to check out the 
item for their own modification, editing, etc. 

Thus, the SCC system 202 is able to store different versions 
of the same piece of code - such as different versions of the 
same stored procedure. When a stored procedure is checked out, 
for example, edited, saved to the database, and checked back in, 
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the new version of the stored procedure is saved to the SCC 
system, in a manner that provides for the changes between the new 
version and the previous version or versions to be viewed. That 
is, a change or version history of a given stored procedure can 
be provided by the SCC system 202. 

The mechanism 2 04 is the manner by which a given stored 
procedure is actually checked into and out of the SCC system, so 
that the stored procedure of a database is not modified without 
versioning of the stored procedure taking place. Versioning is 
the process by which different versions of the stored procedure 
are kept track of, for example, by the SCC system 2 02. Thus, as 
shown in FIG. 2, a stored procedure of the database 200 cannot be 
accessed without the mechanism 2 04 knowing about the access, such 
that if modifications are made thereto, the mechanism 204 is able 
to indicate such changes as a new version of the stored procedure 
via the SCC system 202. In another embodiment, the database 
system 200 is itself able to invoke the mechanism 204, on any 
read access to the stream 212, to provide the benefits of the 
invention to users who do not choose to use the editor 2 06 as the 
computer program used to manipulate the stream 212, as described 
in the next paragraph. 

The editor 206 is a specific type of a computer program that 
manipulates the stored procedures of the database 200. In 



particular, the editor 206 is a program that provides for the 
editing of the stored procedures of the database 200. The 
invention is not so limited to a program that is an editor 
program, however -- that is, the invention is amenable to any- 
type of computer program that is used to manipulate database 
items such as stored procedures of the database 200. In one 
embodiment, the editor 206 is part of the Visual Studio 
development environment already described, such that the editor 
206 includes a "data view" of all the tables and the stored 
procedures, among other data and code, stored in the database 
200. The invention is not so limited, however. 

The system of FIG. 2 operates as follows. The editor 206 
desires to retrieve a stored procedure of the database 200 for 
editing and modification. Thus, the editor 206 requests to check 
out the stored procedure, such that the mechanism 2 04 checks out 
the desired stored procedure thereto. The mechanism 2 04 does 
this as follows. It retrieves the stored procedure as stored in 
the database 200, as well as the same stored procedure as stored' 
in the SCC system 202. If the version of the stored procedure in 
the database 200 is the same as in the SCC system 202, then this 
version is provided to the editor 206. Otherwise, the editor 206 
has the ability to choose from either version as the version it 
wishes to edit and modify. If it is the SCC system version, then 



this version is automatically saved to the database 200 as the 
database version, too, by the mechanism 204. Thus, the version 
of the stored procedure at the database 200 can be either 
identical to or different than the version of the stored 
procedure at the SCC system 2 02. 

Once the editor 2 06 has edited and modified the stored 
procedure, it is saved to the database 2 00 as the database 
version of the stored procedure. This version is then retrieved 
by the mechanism 204 to check into the SCC system 202 as the 
newest version of the stored procedure as saved by the SCC system 
202. In other words, the mechanism 204 checks in (i.e., saves) 
the stored procedure into the SCC system 200, checking in the 
stored procedure as has been saved to the database 200. 

Methods 

In this section, a check-out method and a check-in method, 
according to different embodiments of the invention, are 
described. These methods can be performed, for example, by the 
mechanism 204 of the system of FIG. 2 that has been described in 
the preceding section, although the invention is not so limited. 

These computer- implemented methods are desirably realized at 
least in part as one or more programs running on a computer -- 
that is, as a program executed from a computer-readable medium 



such as a memory by a processor of a computer. The programs are 
desirably storable on a machine-readable medium such as a floppy 
disk or a CD-ROM, for distribution and installation and execution 
on another computer. 

Referring first to FIG. 3, a computer- implemented check-out 
method according to an embodiment of the invention is shown. The 
check-out method of FIG. 3 is a manner by which a stored 
procedure can be checked out from a SCC system, according to one 
embodiment. It may be performed, for example, when an editor or 
other program indicates to the mechanism that it wishes to edit 
or otherwise manipulate the stored procedure. In 300, the 
desired stored procedure is checked out from the SCC system - 
that is, it is indicated to the SCC system that the stored 
procedure is to be indicated as checked out. In 3 02, the SCC 
system version of the stored procedure stream is retrieved, and 
in 3 04, the database version of the stored procedure stream is 
retrieved. 

In 3 06, the SCC system version of the stored procedure 
stream is compared to the database version of the stored 
procedure stream. If they are the same, then the method is done 
at 3 08 - that is, the editor or other program can now conduct 
editing or other manipulation of the stored procedure. 
Otherwise, in 310, the user is asked to select either the SCC 
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system version or the database version of the stored procedure 
stream. For example, this may be accomplished within the editor 
or other program that will be used to edit or otherwise 
manipulate the desired source procedure. If the database version 
is chosen, then the method proceeds from 312 to 308, and is done 
- that is, the editor or other program can now conduct editing or 
other manipulation of the stored procedure. Otherwise, in 314, 
the mechanism saves the SCC syfetem version of the stored 
procedure stream to the database (such that the database version 
of the stored procedure stream is now the . same as the SCC system 
version), and the method also ends at 308, where the editor or 
other program can now conduct editing or other manipulation of 
the stored procedure . 

Once the editor or other program has finished its editing or 
other manipulation of the stored procedure, than the procedure 
must be checked back into the SCC system. This is accomplished 
by the method shown in FIG . 4. The method of FIG. 4 assumes that 
the stored procedure stream has already been saved by the editor 
or other program back to the database; however, the invention is 
not so limited - for example, this functionality can also be 
performed within the context of the method of FIG. 4, too. In 
400, then, the stored procedure stream is retrieved by the 
mechanism, from the database (if the stream as modified- or edited 



has not already been saved to the database, then this is first 
accomplished) . 

Next, in 402, this version of the stored procedure stream is 
checked back into the SCC system. That is, the stored procedure 
stream is saved to the SCC system as the newest version of this 
stored procedure. Furthermore, the SCC system is also told to 
indicate that the stored procedure stream has now been checked 
in, such that it may be subsequently check out. In at least one 
embodiment of the invention, for example, a stored procedure 
stream cannot be checked out unless it is indicated in the SCC 
system as having been checked in - that is, two different 
programs cannot check out the same stored procedure stream at the 
same time. The invention is not so limited, however. The method 
of FIG. 4 ends at 404. 



Conclusion 

Versioning of stored procedures of databases has been 
described. Although specific embodiments have been illustrated 
and described herein, it will be appreciated by those of ordinary 
skill in the art that any arrangement which is calculated to 
achieve the same purpose may be substituted for the specific 
embodiments shown. For example, the specification has been 
described in relation to database items that are stored 
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procedures, but the invention itself is not so limited. This 
application is intended to cover any adaptations or variations 
the present invention. For example, the invention can be used 
relation to any type of database item, such as views, triggers, 
constraints, persisted queries and scripts for creating any 
database object, such as tables, indexes, domains, etc. 
Therefore, it is manifestly intended that this invention be 
limited only by the following claims and equivalents thereof. 



